home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / mailers / wregnode.zip / READTHIS.FIL < prev    next >
Text File  |  1992-05-21  |  7KB  |  144 lines
  1.  
  2.  
  3.                         RegNode v.1.00
  4.                     (C)1982, Ray L. Kaliss
  5.                Instructions for use with Win*Net,
  6.              the Windows file distribution network!
  7. ---------------------------------------------------------------------
  8.  
  9. Hello and welcome to Win*Net, if you're new, and thanks a million, if
  10. you're a grizzled veteran of the file-distribution wars.  This document
  11. supplements the instructions for the use of RegNode included in the
  12. RegNode archive with specific hints/instuctions for Win*Net participating
  13. nodes.  This document was printed on recycled paper, if that's what was
  14. in your printer.  The accompanying software comes with no guarantees
  15. whatsoever.  Contents may settle during shipment, and your mileage may
  16. vary.
  17.  
  18.        ------   What's this "REGNODE" thing anyway?   -----
  19.  
  20. Regnode is a specialized database compiler for use with FidoNet-
  21. compatible systems, and is used to collect and compile the "WINNET.MAP"
  22. file listing of nodes hooked into the Win*Net distribution system.
  23. This is useful within Win*Net for determining routing and "member" 
  24. nodes, and the comipled listing (as periodically updated) will be
  25. distributed upblicly so that (1) users know what BBS'es carry Win*Net;
  26. and (2) prospective new BBS'es know places to look for a possible
  27. link into the system.  Win*Net has grown to the point that it is 
  28. impossible to keep such a list manually.  RegNode will simplify and
  29. automate the list-making process.  At least, that's the intent.
  30.  
  31. There is far more complete, generalized documentation in the archive,
  32. in the file REGNODE.PRN.  You should read that document for instructions
  33. on RegNode setup and operation.  You should read this document for
  34. information specific to using RegNode with the Win*Net system.  You 
  35. should read Tristram Shandy by Lawrence Sterne for an understanding
  36. of the use of the persona in early English novel forms.
  37.  
  38.                     ----  How's it work? ----
  39.  
  40. RegNode works on a bottom-up distribution system.  As Win*Net files are
  41. sent "down" through a branching distribution system, RegNode "registration"
  42. files are sent "upstream" from end nodes to their uplinks, and so on
  43. in turn until all the information arrives here at 1:130/38 and is compiled
  44. and published as the file WINNET.MAP.  If you want to be listed, you *must*
  45. assemble a registration file in the format:
  46.  
  47. @WIN     
  48. 1:123/456 Joe Sysop, Another BBS, Anytown, Ohio USA 310-555-1212
  49. Specializing in batch file menus for DOS systems.
  50. 1:123/222
  51.  
  52. ...that's it.  Four lines.  IF YOU DON'T SEND Win*Net FILES YOU RECEIVE
  53. ON TO ANOTHER NODE (i.e. if you are an "end node" in the Win*Net
  54. distribution chain), just create this file, name it with the letter "W"
  55. followed by your net/node address (no slashes), and file-attach it to
  56. whoever feeds you the Win*Net files.  You don't have to run RegNode.  For
  57. you end nodes, more information about the format of the "registration"
  58. file is contained in REGNODE.CFG in this archive, but since you don't
  59. need to run RegNode, you won't need a configuration file or a .LST fle
  60. or any of that stuff.  Stop reading now, create the file with any 
  61. ASCII editor, and send it to your uplink.  You're done.
  62.  
  63.                  ************* HOWEVER! **************
  64.  
  65. ...if you receive Win*Net files and in turn send them with TICK or FLEA
  66. off to other boards, you are an intermediate link rather than an end node,
  67. and you need to run RegNode.  You also need to create two files, REGNODE.CFG
  68. and REGNODE.LST.  Sample files with comments are included, and also
  69. described in REGNODE.PRN.  REGNODE.CFG contains some file-path information
  70. for RegNode, as well as your own BBS information in the same format as
  71. above.  REGNODE.LST is a routing file, and shows the "downlinks" (nodes you
  72. feed) who will be sending you registration files.  RegNode needs both of
  73. these to run.
  74.  
  75. When you have created these files, you are ready to run RegNode.  Place the
  76. files and the executables in one directory, change to that directory and
  77. test your setup by entering:
  78.                                REGNODE -t
  79.  
  80. ...that will test your configuration.  If everything looks right, force
  81. RegNode to compile an "outfile" like this:
  82.  
  83.                                REGNODE -c
  84.  
  85. ...you will get a file named whatever you called your "outfile" in
  86. REGNODE.CFG.  You may also get a file called REGNODE.RPT; this is a
  87. list of the downstream nodes you named in REGNODE.LST for which
  88. RegNode could not find a registration file.  The outfile gets sent
  89. "upstream" by file-attach.  The nodes in REGNODE.RPT should perhaps
  90. receive some friendly netmail to the effect that you haven't received
  91. their registration file (hint, hint).
  92.  
  93. If you are a "member" of multiple file-distribution systems like SDS,
  94. SDN, etc., you will need a separate REGNODE.CFG file for each, with a
  95. unique name for each file.  Let's say the Win*Net configuration file
  96. is called WINNET.CFG.  You can tell regnode to use this file on the
  97. command line:
  98.                          REGNODE -c WINNET
  99.  
  100. ...the .CFG extension will be assumed by RegNode.
  101.  
  102. RegNode will create a couple of other files in its directory, as 
  103. indicated in the REGNODE.PRN file.  These take care of themselves.
  104. You can just leave them alone.
  105.  
  106.                 ----- When should I run RegNode? -----
  107.  
  108. Regularly.  Every now and then.  Weekly, if that's how often you poll
  109. your uplink.  Every time you get a new registration file from a downlink.
  110. During the Vernal Equinox.
  111.  
  112. I'm not going to attempt a day-of-the-month prescription for Win*Net, 
  113. because we're not as organized as some of the big guys, with named
  114. distribution levels.  Heck, we're lucky this works at all!  But for the
  115. list of nodes to be meaningful, RegNode should be run by intermediate
  116. nodes:
  117.      (1) once, initially, when most or all of the downstream link 
  118.          information is ready;
  119.      (2) on some regular basis, perhaps corresponding to a periodic
  120.          maintenance event on your BBS;
  121.      (3) any time you get a new link downstream or a new registration
  122.          file from an existing link; and
  123.      (4) in any event, at least monthly.
  124.  
  125. You can do (1) and (3) manually.  You can add (2) to your batch file, 
  126. automating both the RegNode compilation and the file-attach with a 
  127. file-attach utility like PLEASE.  And you can periodically test for
  128. incoming registration files in a batch file...if, for example, all your
  129. downlink were in nets 130 and 114, you could do something like this:
  130.  
  131.      IF EXIST C:\FILE\NET\W130*.* GOTO WREGNODE
  132.      IF EXIST C:\FILE\NET\W114*.* GOTO WREGNODE
  133.     ------
  134.      :WREGNODE
  135.      REGNODE -c <config filename if necessary>
  136.      PLEASE SEND <outfile name> TO <uplink>
  137.      GOTO ELSEWHERE
  138.  
  139.                     ---- Thanks and Appreciation ----
  140.  
  141. ...to Ray Kaliss of SDN for writing RegNode, and to you for helping us
  142. keep track of Win*Net nodes!
  143.  
  144. -Larry